home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / gldrawbuffer.z / gldrawbuffer
Encoding:
Text File  |  2001-04-17  |  8.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllDDDDrrrraaaawwwwBBBBuuuuffffffffeeeerrrr((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllDDDDrrrraaaawwwwBBBBuuuuffffffffeeeerrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllDDDDrrrraaaawwwwBBBBuuuuffffffffeeeerrrr - specify which color buffers are to be drawn into
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllDDDDrrrraaaawwwwBBBBuuuuffffffffeeeerrrr( GLenum _m_o_d_e )
  14.  
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _m_o_d_e  Specifies up to four color buffers to be drawn into.  Symbolic
  18.            constants GGGGLLLL____NNNNOOOONNNNEEEE, GGGGLLLL____FFFFRRRROOOONNNNTTTT____LLLLEEEEFFFFTTTT, GGGGLLLL____FFFFRRRROOOONNNNTTTT____RRRRIIIIGGGGHHHHTTTT, GGGGLLLL____BBBBAAAACCCCKKKK____LLLLEEEEFFFFTTTT,
  19.            GGGGLLLL____BBBBAAAACCCCKKKK____RRRRIIIIGGGGHHHHTTTT, GGGGLLLL____FFFFRRRROOOONNNNTTTT, GGGGLLLL____BBBBAAAACCCCKKKK, GGGGLLLL____LLLLEEEEFFFFTTTT, GGGGLLLL____RRRRIIIIGGGGHHHHTTTT,
  20.            GGGGLLLL____FFFFRRRROOOONNNNTTTT____AAAANNNNDDDD____BBBBAAAACCCCKKKK, and GGGGLLLL____AAAAUUUUXXXX_i, where _i is between 0 and
  21.            ``GGGGLLLL____AAAAUUUUXXXX____BBBBUUUUFFFFFFFFEEEERRRRSSSS'' -1, are accepted (GGGGLLLL____AAAAUUUUXXXX____BBBBUUUUFFFFFFFFEEEERRRRSSSS is not the
  22.            upper limit; use ggggllllGGGGeeeetttt to query the number of available aux
  23.            buffers.)  The initial value is GGGGLLLL____FFFFRRRROOOONNNNTTTT for single-buffered
  24.            contexts, and GGGGLLLL____BBBBAAAACCCCKKKK for double-buffered contexts.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      When colors are written to the frame buffer, they are written into the
  28.      color buffers specified by ggggllllDDDDrrrraaaawwwwBBBBuuuuffffffffeeeerrrr.  The specifications are as
  29.      follows:
  30.  
  31.      GGGGLLLL____NNNNOOOONNNNEEEE                  No color buffers are written.
  32.  
  33.      GGGGLLLL____FFFFRRRROOOONNNNTTTT____LLLLEEEEFFFFTTTT            Only the front left color buffer is written.
  34.  
  35.      GGGGLLLL____FFFFRRRROOOONNNNTTTT____RRRRIIIIGGGGHHHHTTTT           Only the front right color buffer is written.
  36.  
  37.      GGGGLLLL____BBBBAAAACCCCKKKK____LLLLEEEEFFFFTTTT             Only the back left color buffer is written.
  38.  
  39.      GGGGLLLL____BBBBAAAACCCCKKKK____RRRRIIIIGGGGHHHHTTTT            Only the back right color buffer is written.
  40.  
  41.      GGGGLLLL____FFFFRRRROOOONNNNTTTT                 Only the front left and front right color
  42.                               buffers are written.  If there is no front right
  43.                               color buffer, only the front left color buffer
  44.                               is written.
  45.  
  46.      GGGGLLLL____BBBBAAAACCCCKKKK                  Only the back left and back right color buffers
  47.                               are written.  If there is no back right color
  48.                               buffer, only the back left color buffer is
  49.                               written.
  50.  
  51.      GGGGLLLL____LLLLEEEEFFFFTTTT                  Only the front left and back left color buffers
  52.                               are written.  If there is no back left color
  53.                               buffer, only the front left color buffer is
  54.                               written.
  55.  
  56.      GGGGLLLL____RRRRIIIIGGGGHHHHTTTT                 Only the front right and back right color
  57.                               buffers are written.  If there is no back right
  58.                               color buffer, only the front right color buffer
  59.                               is written.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllDDDDrrrraaaawwwwBBBBuuuuffffffffeeeerrrr((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllDDDDrrrraaaawwwwBBBBuuuuffffffffeeeerrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____FFFFRRRROOOONNNNTTTT____AAAANNNNDDDD____BBBBAAAACCCCKKKK        All the front and back color buffers (front
  75.                               left, front right, back left, back right) are
  76.                               written.  If there are no back color buffers,
  77.                               only the front left and front right color
  78.                               buffers are written.  If there are no right
  79.                               color buffers, only the front left and back left
  80.                               color buffers are written.  If there are no
  81.                               right or back color buffers, only the front left
  82.                               color buffer is written.
  83.  
  84.      GGGGLLLL____AAAAUUUUXXXX_i                  Only auxiliary color buffer _i is written.
  85.  
  86.      If more than one color buffer is selected for drawing, then blending or
  87.      logical operations are computed and applied independently for each color
  88.      buffer and can produce different results in each buffer.
  89.  
  90.      Monoscopic contexts include only _l_e_f_t buffers, and stereoscopic contexts
  91.      include both _l_e_f_t and _r_i_g_h_t buffers.  Likewise, single-buffered contexts
  92.      include only _f_r_o_n_t buffers, and double-buffered contexts include both
  93.      _f_r_o_n_t and _b_a_c_k buffers.  The context is selected at GL initialization.
  94.  
  95. NNNNOOOOTTTTEEEESSSS
  96.      It is always the case that GGGGLLLL____AAAAUUUUXXXXi = GGGGLLLL____AAAAUUUUXXXX0000 + i.
  97.  
  98. EEEERRRRRRRROOOORRRRSSSS
  99.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is not an accepted value.
  100.  
  101.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if none of the buffers indicated by
  102.      _m_o_d_e exists.
  103.  
  104.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllDDDDrrrraaaawwwwBBBBuuuuffffffffeeeerrrr is executed between the
  105.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  106.  
  107. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  108.      ggggllllGGGGeeeetttt with argument GGGGLLLL____DDDDRRRRAAAAWWWW____BBBBUUUUFFFFFFFFEEEERRRR
  109.      ggggllllGGGGeeeetttt with argument GGGGLLLL____AAAAUUUUXXXX____BBBBUUUUFFFFFFFFEEEERRRRSSSS
  110.  
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      ggggllllBBBBlllleeeennnnddddFFFFuuuunnnncccc, ggggllllCCCCoooolllloooorrrrMMMMaaaasssskkkk, ggggllllIIIInnnnddddeeeexxxxMMMMaaaasssskkkk, ggggllllLLLLooooggggiiiiccccOOOOpppp, ggggllllRRRReeeeaaaaddddBBBBuuuuffffffffeeeerrrr
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.